home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / bgfaxb01.zip / BGFAX.HLP < prev    next >
Text File  |  1993-06-19  |  14KB  |  370 lines
  1. This is the BGFAX help file where I will both my comments and other
  2. people's comments and helpful hints on getting BGFAX set up with their
  3. particular FidoNet mailer software.
  4.  
  5. * FD 2.02/NC  (thanks to a guy from Internet for showing me how!)
  6.   FD 2.20 Beta  (supposedly easier to set up with, I've heard)
  7. * Intermail 2.21  (I tested it with the trial version)
  8.   PC Board Beta  (by the new Errorlevel 7 exit for fax, I've heard)
  9.   GT Power Beta  (by the new GT_FAX.BAT file)
  10.   Dutchie 3.0 Gamma (I've heard)
  11. * D'Bridge 1.53
  12. * Binkley
  13.  
  14. --------------------------------------------------------------------------
  15. Setup hints for using BGFAX with FD 2.02/NC  (06-18-93)
  16. B.J. Guillot
  17. Internet: st1r8@jetson.uh.edu
  18. Fidonet: 1:106/400 (PENDING APPROVAL)
  19. --------------------------------------------------------------------------
  20.  
  21. IMPORTANT ANNOUNCEMENT!  FRONTDOOR 2.02/NC WORKS WITH BGFAX!
  22.  
  23. For the past few weeks, I claimed that FD 2.02/NC would not work wih BGFAX
  24. because it was "too slow", etc.  I was wrong!  I was going about setting up
  25. FD the wrong way.  (Be advised I got my finger smashed against a rock
  26. earlier today and its a pain typing right now, so I may start getting brief
  27. towards the end of my message.)
  28.  
  29. Note that BGFAX is a program that offers (1) a frontend mode that answers
  30. the phone and will pass data calls to your BBS software and take faxes,
  31. and, offers (2) a rearend mode that allows an already running frontend
  32. (such as a Fido mailer) to pass control to it on FAX calls and take it.
  33.  
  34. Note that BGFAX requires a Class 2 compatible fax modem with adaptive
  35. answer.  This means the Supra, ZyXEL, Zoom, Practical Peripherals, etc.
  36. should all be compatible.  NOTE THAT THE USR, AT&T DATAPORT, AND THE
  37. DIGICOM MODEMS ARE NOT PRESENTLY COMPATIBLE SINCE THEY OFFER ONLY CLASS 1
  38. FAX SUPPORT!
  39.  
  40. Here is the relevant information from FDSETUP ...
  41.  
  42. [FDSETUP]  Modem -> Command Strings
  43.   Init-1 ... ATZ|
  44.   Init-2 ... ATE0|
  45.   Init-3 ... AT+FAA=1;+FCR=1;+FLID="BJ GUILLOT"|
  46.  
  47. There's a bunch more, but let me do a little explaining first.  My init-2 is
  48. ATE0 because FD starts choking on the third init string if you have echo
  49. enabled.  (That's because of something we'll tell FD in just a minute.)  If
  50. your modem already has E0 in NVRAM that line will be unnessary.
  51.  
  52.   +FAA=1  enables adaptive answer (VERY IMPORTANT!)
  53.   +FCR=1  enables fax receiption (VERY IMPORTANT!)
  54.   +FLID="xxxxx"     sets your FAX ID, it can be up to 20 characters,
  55.                     but you'll only have room for about 10 in FDSETUP.
  56.  
  57. Some modems allow you to put the +FAA and +FLID settings in NVRAM, but I
  58. don't think I've seen a modem yet that stores the +FCR in NVRAM.
  59.  
  60. [FDSETUP] Modem -> Answer control
  61.   Force answer ... AT+FAA=1;A
  62.  
  63. Some modems "forget" the +FAA setting after answering a call, so this is
  64. only done to make sure adaptive answering is enabled.
  65.  
  66. [FDSETUP] Mailer -> Errorlevls
  67.  
  68. 1275 ... 254       (or whatever, although, I recommend using a number as
  69.                    close to 255 as possible since it gives a slight
  70.                    advantage speed wise; remember, faxing is very time
  71.                    critical.)
  72.  
  73. Okay, here are the settings ***** METHOD #1 *****  (Preferred method)
  74.  
  75. Some modems return a "get ready" message before the fax modems actually
  76. start mating.  My modem, a Supra, reports "FAX" when it hears the remote
  77. machine make a CNG tone.  The ZyXEL, for example, reports "CONNECT FAX",
  78. and other modems report "CONNECT 9600/FAX", etc.  UHOH ... Now that I think
  79. of it, I'm not sure that this method will work with non-Supras, because the
  80. "CONNECT" part might through FD off.  This is the preferred method because
  81. (on the Supra anyway), the "FAX" message comes about 2 seconds before the
  82. faxes start mating which gives time for FD to exit and BGFAX to load.  (I
  83. only have a 286/8 machine FYI, just a poor college kid in summer.)
  84.  
  85. [FDSETUP] Modem -> Messages
  86.  
  87. 1275 ... F              (yes, a SINGLE letter F without pipes, etc.)
  88.  
  89. [FDSETUP] Mailer -> External mail
  90.  
  91.    String                                     Level
  92. 1  X                                          254
  93.  
  94.  
  95. (That 254 is the same errorlevel I specified for 1275.)  Notice that "FAX"
  96. is what my modem returns, thus "F" and "X".  See?
  97.  
  98. FDRUN.BAT (or whatever) should contain:
  99.  
  100. if errorlevel 254 rearend
  101.  
  102. REAREND.BAT has one line:
  103.  
  104. BGFAX /FAX
  105.  
  106. Okay, here are the settings ***** METHOD #2 *****  (Alternate method)
  107.  
  108. Modems also report a "+FCON" when they get connected (after they make the
  109. first move in their mating dance.)  Do this if Method #1 will not work for
  110. you:
  111.  
  112. [FDSETUP] Modem -> Messages
  113.  
  114. 1275 ... +FC              (yes, the three characters +, F, and C)
  115.  
  116. [FDSETUP] Mailer -> External mail
  117.  
  118.    String                                     Level
  119. 1  N                                          254
  120.  
  121. See "+FC" and "N" come from +FCON.
  122.  
  123. FDRUN.BAT (or whatever) should contain:
  124.  
  125. if errorlevel 254 rearend
  126.  
  127. REAREND.BAT has one line:
  128.  
  129. BGFAX /FCON
  130.  
  131. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  132.  
  133. --------------------------------------------------------------------------
  134. Setup hints for using BGFAX with Intermail 2.21  (06-18-93)
  135. B.J. Guillot
  136. Internet: st1r8@jetson.uh.edu
  137. Fidonet: 1:106/400 (PENDING APPROVAL)
  138. --------------------------------------------------------------------------
  139.  
  140. IMSETUP.EXE ... Modem -> Advanced setup -> Command strings
  141.  
  142. Init-1     ATZ|
  143. Init-2     AT+FCR=1|             (+FCR=1 is VERY important)
  144. Init-3     AT+FLID="TRANQUILITY BASE"|
  145.  
  146. IMSETUP.EXE ... Modem -> Advanced setup -> Answer control
  147.  
  148. Manual answer    Yes
  149. Force answer     AT+FAA=1A|  (that's all that will fit, I know that some
  150.                              modems likes AT+FAA=1;A| with a sem, so
  151.                              modem owners may want to try and add +FAA=1 to
  152.                              one of the init strings and just use ATA|)
  153.  
  154. IMSETUP.EXE ... Modem -> Advanced setup -> Connect strings
  155.  
  156. You will see a list of 14 or so preconfigured connect strings, press
  157. <INSERT> to add one, and set it up like so:
  158.  
  159.   Connect Message                          Speed  EC  BBSexit  Terminate
  160.  
  161.   FAX                                      19200  N   0        254
  162.             <or if your modem doesn't support that>
  163.   +FCON                                    19200  N   0        254
  164.  
  165. -------------------------------------------------------------------------
  166.  
  167. "FAX" is the string my SupraFax Modem returns when it hears the Fax CNG
  168. tone from the remote modem/machine.  I belive the ZyXEL returns "CONNECT
  169. FAX", and some modems return "CONNECT 9600/FAX", etc.  You will have to
  170. find out which your modem uses.  (The modems that don't report this answer
  171. will always wind up reporting "+FCON", so use that as an alternate choice)
  172.  
  173. Notice that "BBSexit" is equal to ZERO.  It should stay like that!  Notice
  174. that "Terminate" is equal to "254".  This number can be set to whatever you
  175. want as long as its NOT ZERO (and any other value Intermail is picky
  176. about).  I set it so that when Intermail receives the string "FAX" it will
  177. IMMEDIATELY exit with an errorlevel of 254.  (Notice IMMEDIATELY, it
  178. doesn't twiddle around like Frontdoor).
  179.  
  180. Here's the sample testing batch file I used for BGFAX, IMBATCH.BAT:
  181.  
  182. @echo off
  183. im
  184. if errorlevel 254 goto fax
  185. goto end
  186. :fax
  187.   bgfax /fax
  188. :end
  189. imbatch
  190.  
  191. Notice I don't include any BBS handling errorlevel instructions.  You'll
  192. have to do that yourself (it's all configured in "Connect strings").
  193.  
  194. By the way, I tested this both with and without the BNU fossil driver
  195. loaded.  (Note that BGFAX does not use a fossil driver.  Also note that
  196. Intermail can use one, but doesn't have to as it has its own SIO
  197. communications routines built-in as well.)
  198.  
  199. Just for kicks, I decided to test Intermail and BGFAX rear end mode with
  200. the /FCON parameter.  Some fax modems do not transmit any kind of "FAX" or
  201. "CONNECT FAX" warning messages, only the "+FCON" (which means the faxes
  202. have passed first base in their mating game.)  I changed my Intermail setup
  203. string from "FAX" to "+FCON" to do this test.  I also changed my
  204. IMBATCH.BAT file line that read "bgfax /fax" to "bgfax /fcon".  The
  205. first fax call attempt I made JUST BARELY made it.  In fact, the fax DCE
  206. downshifted from 9600 to 7200 because my computer (286/8 mhz) was too slow.
  207. I thought that was a miracle.  It should have hung up!  Anyway, I tried
  208. again, and it seemed the disk cache had kicked in, and the transfer went
  209. through.
  210.  
  211. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  212.  
  213. --------------------------------------------------------------------------
  214. Setup hints for using BGFAX with Dbridge  (06-18-93)
  215. Randy Fox
  216. Fidonet: 1:363/60
  217. --------------------------------------------------------------------------
  218.  
  219. Here is the Dbridge set up that we discussed about the other night.
  220.  
  221. All the people need to do is the following:
  222.  
  223. 1) Edit the MCF File they are using.  in my case BOCA3242.mcf
  224. 2) Change the "INIT" Line to look something like this:
  225.    (some additional commands may be needed for regular modem use.  I left
  226.     my extras out for less confusion.)
  227.     The file starts off looking like this:
  228.  
  229.     MCF Boca3242 Boca V32b/MNP/V42b
  230.     BAUD 38400
  231.     LOCKED
  232.     DELAY 60
  233.     TIMEOUT 65
  234.     PREINIT ATZ   <----This line can be ommited or altered, but is only sent
  235.                        once upon loading D'bridge
  236.  
  237.     INIT ATH0N1&K3+FCR=1+FAA=1+FLID="MY FAX MACHINE"
  238.     OFFHOOK ATM0H1
  239.     etc....
  240.  
  241. (Note: in the mcf there is no blank lines between the entries, I just ran out
  242. of room for the explaination.)
  243.  
  244. Then, they need to load dbridge and go under Utilities;Security/Miscellaneous.
  245.  
  246. In the EXTERNAL RECIEVERS box they need to enter:
  247.  
  248. FAX|C:\FAX\BGFAX /FAX
  249.     The word FAX before the pipe is the modem response, may need to be
  250.     CONNECT FAX is some instances, or +FCON.  After the pipe is the command
  251.     line for the reciever.  This is the quickest way to load BGFAX if you
  252.     have enough overhead ram.  this is just a small dos shell method.
  253.  
  254. Another option:  after the PIPE symbol, they may speccify a batch file to call
  255. BGFAX.  ie: FAX|FAX.BAT
  256.  
  257. If there is not enough over head ram, they may try swapping Dbridge out by
  258. placing a "+" sign in front of the command line: FAX|+FAX.BAT
  259.  
  260. Or the may drop Dbridge and exit at errorlevel: FAX|*X100 (100 errorlevel)
  261.  
  262. --------------------------------------------------------------------------
  263. Setup hints for using BGFAX with Binkley  (06-18-93)
  264. Art Geary
  265. 1:393/101@fidonet
  266. --------------------------------------------------------------------------
  267.  
  268.                              BinkleyTerm and PPI 14400FXSA Fax
  269.  
  270.    I have run Binkley for a number of years, and act as the mail hub for my
  271.    Net. I did not want to change to some other mailer. I also bought a
  272.    Practical Peripherals 14400FXSA modem, and wanted to be able to continue to
  273.    do my mail and recieve fax's on the same line.
  274.  
  275.    There seemed to be no way to do it. Then along came BGFax. This program can
  276.    either Front-end or Rear-end a BBS. Thank you B.J. Guillot.
  277.  
  278.    Here is my cludge....
  279.  
  280.            1.      Set up BGFax to Front end. See BGFAX.CNF.
  281.                    Event times are set 1 minute before my Binkley.evt file
  282.                    times.
  283.            2.      Add 'Server' verb to Binkley.cfg.
  284.            3.      Tweak Binkley batch file. See BINK.BAT.
  285.  
  286.    Works fine here on 16MHz 386SX.
  287.  
  288.    Only bad thing is that the %'s on transfer rate will be wrong if BGFAX
  289.    answers phone.
  290.  
  291.    BGFAX.CNF
  292.  
  293.    po=1
  294.    ft=q
  295.    sp=19200
  296.    in=ATZ
  297.    in=AT+FAA=1;+FCR=1;+FLID="UNIWARE"
  298.    in=ATM0
  299.    ri=1
  300.    an=AT+FAA=1;A
  301.    do=<load>
  302.    lo=
  303.    ec=/ARQ
  304.    sl=300
  305.    ts=Calls are not accepted below 1200 bps.  Sorry.
  306.    cm=CQ,104
  307.    ev=23:59,124
  308.    ev=00:29,123
  309.    ev=01:59,122
  310.    ev=03:59,121
  311.    ev=04:59,120
  312.    ev=05:49,119
  313.    ev=06:29,118
  314.    ev=06:59,117
  315.    ev=21:58,115
  316.    ev=22:58,116
  317.  
  318.    BINK.BAT
  319.  
  320.    c:
  321.    cd \max
  322.    cls
  323.    vfos_ibm
  324.    echo off
  325.    :start
  326.    :chkcra
  327.    REM IF CRASH MAIL WAITING TO GO OUT, BYPASS BGFax
  328.    if exist \max\outbound\*.cl* goto loop
  329.    :bfax
  330.    bgfax
  331.    if errorlevel 124 goto loop
  332.    if errorlevel 123 goto loop
  333.    if errorlevel 122 goto loop
  334.    if errorlevel 121 goto loop
  335.    if errorlevel 120 goto loop
  336.    if errorlevel 119 goto loop
  337.    if errorlevel 118 goto loop
  338.    if errorlevel 117 goto loop
  339.    if errorlevel 116 goto loop
  340.    if errorlevel 115 goto loop
  341.    if errorlevel 4 goto start
  342.    if errorlevel 3 goto loop
  343.    if errorlevel 2 goto loop
  344.    if errorlevel 1 goto start
  345.    if errorlevel 0 goto end
  346.    goto chkcra
  347.    :loop
  348.    erase lastuse1.bbs
  349.    btbig unattended share
  350.    if errorlevel 192 goto max192
  351.    ETC...
  352.  
  353.    All routines in the batch file end with goto start.
  354.    Errorlevels 124 - 115 corespond the errorlevels set in BGFAX.CNF.
  355.    I also made my F1 key in Binkley (errorlevel 10) goto bfax to enable a fax
  356.    recieve manually.
  357.  
  358.    Any questions or suggestions to...
  359.  
  360.    Art Geary
  361.    1:393/101@fidonet
  362.    (817) 321-3213  Fax 07:00 - 22:00 CDT  Data 24 hrs.
  363.    (817) 321-3903  Voice
  364.  
  365. Note by BJG ... I don't believe Art's method allows incoming crash mail
  366. calls to Binkley, so I don't know how viable this may be to those of you
  367. running Binkley.  The +FCLASS=0 command was taken out of his second in=
  368. field in BGFAX.CNF because I have discovered that on some modems, it causes
  369. things to reset to factory settings.
  370.